home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / progs / editor / next1.91 / next.doc < prev    next >
Text File  |  1996-11-04  |  35KB  |  883 lines

  1.  
  2.  
  3.                NEXT V1.9
  4.  
  5.            (c) 1993-96 by Jürgen Klawitter
  6.  
  7.                FREEWARE
  8.  
  9.  --------------------------------------------------------------------------
  10.  This version contains mainly bug fixes, which I detected after releasing
  11.  V1.9. There are also some minor improvements. See chapter "History".
  12.  --------------------------------------------------------------------------
  13.  
  14.  NEXT is a fairly compact text viewer written in assembly. Apart from normal
  15.  text files it also accepts binaries, XPK- and powerpacked files and can
  16.  extract LhA- and LZX-archives. AmigaGuide files are displayed as hypertext
  17.  by default but can also be converted to readable ANSI text.
  18.  
  19.  NEXT has efficient functions for loading, analysing and printing texts,
  20.  e.g. scanning of directories with wildcards, print with page title and page
  21.  numbers, a "smart" print mode, word statistics and count of strings/chars.
  22.  Search routines are very fast and display all matches at once on screen.
  23.  Patterns can be used. Search can also be started by clicking on a string.
  24.  NEXT has been tested with OS 1.2 and 3.0.
  25.  
  26.  Other features:
  27.  
  28.   o can be made resident
  29.   o font sensitive, font can be chosen
  30.   o wordwrap
  31.   o marking of blocks by mouse click
  32.   o saving/printing of blocks
  33.   o when saving to an existing file, text can be appended
  34.   o several modes for loading files
  35.   o multiple windows
  36.   o window sizing by simple key press
  37.   o no need for powerpacker.library (internal routine)
  38.  
  39.  
  40.   INSTALLATION/ SHORT INSTRUCTION
  41.  
  42.   Copy NEXT or NEXT.rq (reqtools version, should be renamed to NEXT) some-
  43.   where in your path. You should have asl.library/reqtools.library in LIBS:.
  44.   OS1.x users need arp.library.
  45.   Further on amigaguide.library is needed if AmigaGuide files are to be
  46.   displayed as hypertext. XPK-Libraries, LhA and LZX are necessary for
  47.   xpk-compressed and archived files respectively.
  48.   You can use NEXT without reading this document although it would be better.
  49.   Most commands are compatible to those of More, MuchMore or PPMore. Press
  50.   "Help" in case of need.
  51.  
  52.  
  53.  
  54.    Contents 
  55.  
  56.    1.General remarks              13.Print modes
  57.    2.Start, options              14.Initializing printer
  58.    3.Moving through text          15.Changing window size by key
  59.    4.Messages and input           16.Loading new file
  60.    5.Searching forward/backward       17.Line number
  61.    6.Search by mouseclick          18.AmigaGuide files
  62.    7.Searching text in binary files   19.Info, filenote
  63.    8.Marking a block/line          20.Delete current file
  64.    9.String count              21.%-Display, Goto
  65.   10.Word statistics              22.Archives
  66.   11.Print/Save               23.Tabs
  67.   12.Print with page numbers          24.Splitted files
  68.                       25.History
  69.  
  70.   If you only want to read one of these chapters, you can use a special
  71.   function of NEXT (called MSEARCH): press Ctrl and click with left mouse
  72.   button on the number of the respective chapter.
  73.  
  74.  
  75.  
  76.    1.General remarks 
  77.  
  78.   NEXT will use the system font if at least 79 rows of text can be displayed
  79.   with this font. Otherwise topaz 8 will be used. If the default font is
  80.   smaller than topaz 8, 80 rows will be displayed. You can override this
  81.   behaviour by options FONT and ROWS (see below).
  82.  
  83.   NEXT formats the text before displaying it. That means, lines are wrapped
  84.   at word boundaries if they are too long and nonprintable chars are converted
  85.   to spaces. ESC-sequences for colour, style and printing will not be touched.
  86.   Formfeeds are left intact, too, but will be displayed as L.
  87.   Formatting is done very fast, but will take some instances if a file is
  88.   very long.
  89.  
  90.   Formatting speeds up text display, also binaries can be read like ordinary
  91.   text files. The disadvantage is that the length of lines stays constant
  92.   if window width or tabsize are changed. You have to reload (see RELOAD)
  93.   the current file to adjust lines again.
  94.  
  95.   The window title contains some useful informations, two of which have to be
  96.   explained. Example:
  97.  
  98.    2/16 AMINET11:Aminet/AMINET (262.941 bytes)                     DV*   50% 
  99.    ^                                   ^
  100.    1                                   2
  101.  
  102.   (1) If a file could not be loaded completely into memory, you can see here
  103.       which part of it is currently displayed (part 2 of 16 in this case).
  104.   (2) At this position some status informations may appear:
  105.       D = currentliy displayed file has been deleted
  106.       V = commands "VIEW archive" and "UNPACK archive" can be used
  107.       * = a pattern has been defined, which will be used to scan the
  108.       directory of the currently displayed file. Use "I" (INFO) to see
  109.       which pattern has been defined.
  110.  
  111.  
  112.  
  113.    2.Start 
  114.  
  115.   Workbench:
  116.   ==========
  117.  
  118.   1. Click on NEXT icon and doubleclick on the icon of a file or directory
  119.      (holding down the shift-key)
  120.   2. Set NEXT as the default tool in a text icon and doubleclick on that.
  121.  
  122.   If you only doubleclick on the NEXT icon, a filerequester will appear.
  123.   NEXT uses the asl-requester for OS2+, otherwise the arp-requester.
  124.   A special version of NEXT, next.rq, uses the very comfortable filerequester
  125.   of reqtools.library V37+, (c) by Nico Francois.
  126.  
  127.  
  128.   Shell: > next [file|directory] [options, see below]
  129.   ======
  130.  
  131.   All arguments are optional and can be typed in any order. Without
  132.   arguments the filerequester will open. The same is true if you provide
  133.   the name of a directory. If a wrong name has been given, NEXT tries to
  134.   extract the parent directory from the pathname and presents that.
  135.  
  136.   Instead of a file or directory a pattern with AmigaDos wildcards can be
  137.   used. Patterns for directories must be terminated by a "/". For OS1.2/1.3
  138.   the pattern matching abilities of NEXT are restricted. Only "*" (works
  139.   like #?) and "?" can be used.
  140.  
  141.   After the first file has been loaded, you can continue to scan the
  142.   directory for other files which match the provided pattern, using the
  143.   function LOAD next (>).
  144.  
  145.  
  146.   OPTIONS
  147.   =======
  148.   There are the same options for Workbench and Shell and config file.
  149.   When starting from Workbench they can be defined as tooltypes in the icon
  150.   of NEXT or in the project icon.
  151.  
  152.  
  153.   @LIB/@CON/@PUR  (see chapter 18)
  154.   --------------
  155.   These options influence the display mode of AmigaGuide files.
  156.  
  157.   @LIB: Files are displayed using amigaguide.library. This is the default
  158.     behaviour. So, using this option makes sense only if you have
  159.     defined another mode in the config file.
  160.   @CON: Files will be converted to readable text. All special instructions
  161.     (like @NODE) are stripped or replaced by equivalent ESC-sequences.
  162.     This mode will be activated automatically if @LIB-mode is on but
  163.     amigaguide.library can't be used for some reason.
  164.   @PUR: Files are displayed pure (AmigaGuide instructions can be read).
  165.  
  166.   (The Option @ of previous versions is obsolete and will be ignored.)
  167.  
  168.   ROWS n  (WB: ROWS=n)
  169.   --------------------
  170.   This option sets the maximal number of text rows to be displayed on
  171.   screen (default 79). This will also be the maximal print width.
  172.   Valid values are 40-105. Smaller values will be set to 40, larger ones
  173.   to 105.
  174.  
  175.   LINES(=L) n  (WB: LINES=n)
  176.   --------------------------
  177.   Sets the number of text lines to be displayed at start, is ignored later
  178.   on. Smallest value accepted is 8.
  179.  
  180.   CENTER
  181.   ------
  182.   Centers the window at start. This makes sense only if you have defined
  183.   ROWS and/or LINES on the command line or in next.prefs.
  184.  
  185.   FONT name/n  (WB: FONT=name/n)
  186.   ------------------------------
  187.   "name" is the fontname WITHOUT ".font", n is the size of the font.
  188.   Example: FONT Courier/13 or F Courier/13
  189.   The font must be of fixed width, otherwise it will not be accepted.
  190.   Fontnames should be written case sensitive, especially if you want to
  191.   use topaz/8 or topaz/9.
  192.  
  193.   TABS n (WB: TABS=n)
  194.   -------------------
  195.   Defines the tabsize (n=2-16). Default 8.
  196.  
  197.   BUFLEN n (WB: BUFLEN=n)
  198.   -----------------------
  199.   Defines the size of buffer to be used if a file must be splitted.
  200.   Default: 131072 (128 KB).
  201.  
  202.   LhA path (WB: LhA=path)
  203.   -----------------------
  204.   Defines where the archiver LhA will be looked for in case an archive
  205.   has to be extracted or viewed. Example: lha c:lha. Default ist "LhA".
  206.   Paths which contain spaces must be enclosed by "". You should write this
  207.   option into the config file.
  208.  
  209.   LZX path (WB: LZX=path)
  210.   -----------------------
  211.   Same as LhA.
  212.  
  213.   TEMPDIR path (WB: TEMPDIR=path)
  214.   -------------------------------
  215.   Defines the directory where the archivers will write their temporary files
  216.   to. The directory must exist. It should be in RAM if you have enough
  217.   memory. Default is T:. Within TEMPDIR a subdirectory "x" will be created
  218.   if it doesn't exist.
  219.  
  220.   FLUSH|NOFLUSH
  221.   -------------
  222.   After quitting the program all temporary files including "x" will be
  223.   deleted by default. You can prevent this by choosing NOFLUSH. FLUSH
  224.   overrides NOFLUSH if this has been set in the config file.
  225.  
  226.   Options are treated in the following order:
  227.  
  228.          1. FONT > ROWS > defaults
  229.          2. Shell or Workbench options > next.prefs > internal defaults
  230.  
  231.   That means: A given font will be used, even if a given number of rows
  232.   can't be realized. ROWS has priority above default rows.
  233.   If the number of given rows is too big, NEXT tries zu realize as many
  234.   rows as possible. topaz/8 will be used if the default font is bigger.
  235.  
  236.   The following table gives some examples of usable fonts and the
  237.   maximal number of rows on a standard screen with 640 pixel.
  238.  
  239.   fontwidth  rows    font/size
  240.   --------------------------------------------------------------------
  241.       6      105    thinpaz/8  Courier/11
  242.       7       90    Courier/13
  243.       8       79    topaz/8  topaz/11 pearl/8  look/8  SanS/11
  244.       9       70    Courier/15
  245.      10       63    topaz/9
  246.  
  247.   Configuration file
  248.   ==================
  249.  
  250.   After start NEXT looks for the file "ENV:next.prefs". You have to write
  251.   it yourself and then to copy it to ENVARC: and ENV:. Options must be placed
  252.   at the beginning of a line. Strings which begin after a space or semicolon
  253.   will be ignored.
  254.  
  255. ------------------------------------------------------------------------
  256. ;example configuration
  257.  
  258. font=Courier/13
  259. rows=90
  260. lha=lha             ;no path if LhA is resident
  261. lzx="work:"my archivers/lzx"    ;path contains a space
  262. @con                ;don't use amigaguide.library
  263. noflush             ;keep temporary files
  264. buflen=300000
  265. ;end of config file
  266. ------------------------------------------------------------------------
  267.  
  268.  
  269.  
  270.    3.Moving through text 
  271.  
  272.   As mentioned above key commands for moving are like those of other common
  273.   textviewers. Space goes down one page, Backspace up one page. With cursor
  274.   keys the text can be scrolled up or down. Keys of numeric keypad can be
  275.   used, too. If OS2+ is available text can be moved by the scroll gadget at
  276.   the bottom border of the window.
  277.  
  278.   Many operations can be done by several keys. Press Help-key to get the
  279.   full survey.
  280.  
  281.   The functions RELOAD and VIEW archive display file lists in their own
  282.   window. You can move through these lists with the same keys as in the
  283.   main window (cursor keys, BS and Space).
  284.  
  285.  
  286.  
  287.    4.Messages and input 
  288.  
  289.   Starting with version 1.8, all error messages and informations are given
  290.   by requesters. They can be closed by simple keypress. Return will be
  291.   interpreted as OK, if the requester has an OK-gadget.
  292.  
  293.   Some functions afford an input of strings, e.g. SEARCH. This is typed
  294.   into the line at the bottom of window. Empty input (nothing typed and
  295.   Return pressed) aborts the respective function.
  296.   Apart from printable chars following control chars are accepted:
  297.  
  298.       TAB          Tab key          I \
  299.       ESC          Esc          [  \
  300.       CSI          Alt-Esc          Û   \ displayed
  301.       Linefeed(LF)    Ctrl-J          J   /
  302.       Formfeed(FF)    Ctrl-L          L  /
  303.       Return(CR)      Ctrl-M          M /
  304.  
  305.  
  306.   The input line can be edited similar to shell:
  307.  
  308.       Shift ->          Cursor to end of line
  309.       Cursor up          "
  310.       Shift <-          Cursor to start of line
  311.       Cursor down         "
  312.       Shift-Del       deletes all chars from cursor position to the right
  313.       Ctrl-X          deletes whole line
  314.  
  315.  
  316.  
  317.    5.Searching forward/backward  (SEARCH,BSEARCH/NEXT,PREVIOUS)
  318.  
  319.   Strings can be searched case sensitive (cs) or case insensitive (ci).
  320.   They can contain control chars like LF. This enables e.g. searching of
  321.   strings which continue on next line or finding only words at beginning of
  322.   a line.
  323.  
  324.   NEXT marks all occurrences with background colour 2. Control chars in a
  325.   search string are converted to visible chars (same as input).
  326.   In contrast to most text readers NEXT marks ALL occurrences on screen,
  327.   not only the first match. This is faster and gives much better survey.
  328.  
  329.   Search starts from current position (displayed text included) if a new
  330.   string has been given or if search direction changes.
  331.   Searching forward, the first match will be displayed 2 lines below top
  332.   of window (if possible). Backsearch displays it 2 lines from bottom. So
  333.   you can see what is above/below.
  334.  
  335.   Usually search goes downward after string input. But you can force
  336.   immediate backsearch by additionally pressing one of the Amiga-keys
  337.   (e.g. Amiga-s). You will be prompted by BSEARCH (cs) or bsearch (ci).
  338.  
  339.   Pattern search
  340.   ==============
  341.   From V1.8 on strings to be searched may contain the "?" as wildcard.
  342.   It replaces any alphanumerical character. Input of wildcard is done
  343.   by Help key. It is displayed with colour 2 in contrast to normal "?".
  344.  
  345.   EXAMPLE: Input is "b?g". As result bug, big, bog, bag...
  346.   will be found.
  347.  
  348.   If a pattern contains nothing but wildcards NEXT will look only for
  349.   words with the same length as the pattern. (It wouldn't make much sense
  350.   to display all occurrences without this restriction.)
  351.   In order to search for words with length n the input can be [n].
  352.   Example: [15] starts search for word which contain 15 chars.
  353.  
  354.   ==============
  355.  
  356.   The special search abilities of NEXT may give nice effects.
  357.  
  358.   EXAMPLES:
  359.  
  360.   1. Please press following keys in the same order: S, TAB, Return.
  361.                                       ;
  362.      Result: All TABs are marked (see line above).
  363.  
  364.   2. Marking of spaces: Press S, Space, Return.
  365.      Press R (=Refresh) to get a normal display again.
  366.  
  367.   3. Pattern search: Press S, type "th??" and Return
  368.  
  369.      that they others whether through the pathname either
  370.  
  371.   4. Press S, Alt-Space, Return.
  372.  
  373.                          
  374.              *°!°*       
  375.               (=)          
  376.                                     
  377.                                   
  378.                                                     
  379.                                                      
  380.                           
  381.  
  382.  
  383.   This image is composed of spaces with Code 160.
  384.  
  385.  
  386.    6.Search by mouseclick  (MSEARCH)
  387.  
  388.   Other occurrences of any word on screen can be simply searched by holding
  389.   down Ctrl and clicking on the first (visible) char. This is a nice feature
  390.   not offered by other text readers. Search is ci if you press Ctrl alone but
  391.   will be cs if another qualifier is pressed additionally.
  392.   Direction of search depends on the mousebutton pressed:
  393.  
  394.       Ctrl-LMB (left mousebutton)  ->  forward search
  395.       Ctrl-RMB (right     "     )  ->  backward search
  396.  
  397.   The selected word will be inverted as long as buttons are held down.
  398.   Except the first char all others must be alphanumeric. Point, "_"
  399.   and hyphen are treated as chars if they are placed within the word.
  400.  
  401.   EXAMPLES:
  402.  
  403.       clicked          marked/searched
  404.       ------------------------------------
  405.       Workbench:          Workbench:
  406.       A600/1200          A600/1200
  407.       ;comment          ;comment
  408.       ; comment          ; comment
  409.       Nölle-Neumann       Nölle-Neumann
  410.       12.5.94          12.5.94
  411.  
  412.  
  413.  
  414.    7.Searching text in binary files  (XSEARCH)
  415.  
  416.   This function finds ASCII-strings in programs and other binary files.
  417.   This may be useful e.g. if you want to know which libraries, devices or
  418.   files a program needs to work.
  419.  
  420.   Strings are considered as ASCII if they consist of at least 4 alpha-
  421.   numeric chars. Change of upper case to lower case may occur only at
  422.   beginning of a string, otherwise it will not be marked. There are of
  423.   course many char combinations within a program which are senseless,
  424.   but hitrate of this function is quite good.
  425.  
  426.   XSEARCH starts at current position and can be continued by pressing
  427.   "X". Backsearch is not possible.
  428.  
  429.   If Shift-X is pressed words consisting of 3 chars only can be detected.
  430.   Of course, much more "garbage" is found in this mode.
  431.  
  432.  
  433.  
  434.    8.Marking a block/line  (MARK)
  435.  
  436.   A line can be marked with Shift-RMB or Shift-LMB. The positions are
  437.   stored and indicated by special signs at start of line ( 1 
  438.   for LMB,  2  for RMB). You can jump back to a marked position
  439.   by simply clicking in the window with that mousebutton you used for marking.
  440.   Marks can be shifted by simply Shift-clicking at another line.
  441.  
  442.   Two marks define begin and end of a block, marked lines included.
  443.   The order of marks (1/2 or 2/1) is unimportant. If only one line has been
  444.   marked this line will be taken as a block. A block can be printed or saved.
  445.   It is also used by the function "Word statistics" (see below).
  446.  
  447.   Marks can be removed by pressing Del or by Shift-clicking on them a second
  448.   time.
  449.  
  450.   The following operations can be applied to a block:
  451.  
  452.     - Print
  453.     - Save
  454.     - Word statistics
  455.     - Jump to blockbegin/-end
  456.  
  457.  
  458.  
  459.    9.String count  (COUNT)
  460.  
  461.   This function counts all occurrences of a string or a single char within
  462.   current file. With "C" count is case insensitive, with Shift-C case
  463.   sensitive. The result of count is displayed in a requester. The title
  464.   shows whether count was ci or cs.
  465.   A counted string can also be searched afterwards with "N" (NEXT) or
  466.   "P" (PREVIOUS). On the other hand a previously searched string can be
  467.   counted by pressing Amiga-C. The mode (cs/ci) will be the same.
  468.   If the count string is a pattern consisting of ??? only the number of
  469.   words having the same length will be reported, e.g. "word[3] found 34
  470.   times". [3] indicates that length was 3 chars.
  471.  
  472.   The count function is mainly for analysing texts. You can also use it
  473.   to check whether a certain string occurs in a file without leaving current
  474.   text position.
  475.  
  476.  
  477.  
  478.    10.Word statistics  (COUNT words)
  479.  
  480.   This function is started with "W". It counts the words in whole text
  481.   or block (if defined). Words which are separated by a hyphen at lineend
  482.   are recognized as ONE word. The result is presented by requester:
  483.  
  484.   The first line shows total number of words and average word length.
  485.   The table below presents the occurring lengths, number of words (n) with
  486.   same length and portion of words with same length (%) in text. Maximal
  487.   word length is 30. Longer words (occur very rarely) will be added to
  488.   length 30.
  489.  
  490.   Word definition is the same as explained in chapter 6.
  491.  
  492.   EXAMPLES:   print/save      2 words
  493.           Next.doc          1 word
  494.           A-Z          1 word
  495.           A - Z          2 words
  496.           4711          1 word
  497.  
  498.  
  499.  
  500.    11.Print/Save  (PRINT)
  501.  
  502.   This function saves the text or part of it to PRT: or to a file. Pressing
  503.   Shift-P will save the whole file, pressing "*" will save the currently
  504.   marked block or the text on screen (if no block has been marked).
  505.  
  506.   NEXT checks if printer is online (for parallel port only). If printer
  507.   is online PRT: will be the default output, else you have to type the
  508.   filename you want to save to. "PRT:" can be replaced by a filename if
  509.   you don't want to print.
  510.  
  511.   If the file you want to save to already exists, you'll be asked whether
  512.   it should be overwritten or whether text should be appended. Press "O"
  513.   to overwrite or "A" to append. Any other key will abort.
  514.   The append mode may be useful if you only want to collect some important
  515.   parts of a text file.
  516.  
  517.   While printing NEXT uses the page length defined in printer settings and
  518.   sends a formfeed to the printer after each page (except last page).
  519.   This is NOT the case if the text already contains formfeeds or if output
  520.   goes to a file.
  521.  
  522.  
  523.  
  524.    12.Print with page numbers 
  525.  
  526.   If you want to print/save with page number and a title line on each page
  527.   press Amiga-P or Amiga-* (for block). You'll be asked for the text of
  528.   the title line. Default is the filename, which can be taken over by
  529.   Return. After that you'll be asked for page length, which must be at
  530.   least 3 lines. Default is length in printer settings.
  531.  
  532.   After page length has been stored, NEXT calculates the number of pages
  533.   for print and shows it in window title.
  534.  
  535.   The title line looks like this by default:
  536.  
  537.   Next.dok                                                                  1
  538.  
  539.   Here comes the first line of text...
  540.  
  541.  
  542.   Modifying page header
  543.   =====================
  544.   1. Empty input for title text will cause NEXT to print without title
  545.      line but with the page length you have typed. So you can use other page
  546.      lengths than default length.
  547.   2. If you only type one or more spaces as title text, title header will
  548.      be filled with spaces but page numbers will be printed.
  549.   3. You can type ESC-Sequences in front of title text. This will modify
  550.      the style of title text or influence the whole print, depending
  551.      on the ESC-sequences given. For example <ESC>[0;1m suppresses
  552.      underlined and forces bold style. All ESC-sequences ending with "m"
  553.      will infuence the style of title line only, others influence the whole
  554.      print. Use the manual or press Shift-Help to get more informations.
  555.  
  556.   In contrast to normal print mode all formfeeds within current text will
  557.   be replaced by linefeeds when printing with pageheader. This is necessary
  558.   because new formfeeds are set according to the page length you have chosen.
  559.  
  560.  
  561.  
  562.    13.Print modes  (SMART/BOOK/ODD)
  563.  
  564.   With following keys 3 different print modes can be selected. They can be
  565.   combined.
  566.  
  567.   Key "1"      smart_print  on/off
  568.   Key "2"      book_mode    on/off
  569.   Key "3"      odds_first   on/off
  570.  
  571.  
  572.   (1) smart_print tries to be intelligent and varies the pagelength a bit
  573.       according to structure of text. That means:
  574.  
  575.       If at pageend only one line of a paragraph is left that normally would
  576.       be printed on next page, it will be printed on the same page.
  577.       If at end of page the first lines of a new paragraph or a heading
  578.       appear, they will be printed on the next page. Thus, a printed page may
  579.       be 1 line (max.) longer than defined by printer prefs or input. It may
  580.       also be several lines shorter.
  581.  
  582.       The smart_print mode is DEFAULT, because it gives the better results
  583.       in most cases. If smart_print is switched off, all pages will be
  584.       printed with constant page length. Minimal page length for smart_print
  585.       mode is 11 lines. For shorter pages the normal print mode will be used.
  586.  
  587. HINT: Print a file with pagetitle and pagenumbers to ram:test first,
  588.       load ram:test and look at the result. Then print it to PRT: if
  589.       all is O.K. Use Shift-P (NOT  Amiga-P) this time.
  590.  
  591.  
  592.   (2) The book_mode can be used if a text is printed with page numbers or
  593.       page heading. If this mode is ON the heading of pages with even number
  594.       will be printed in reverse order. Page numbers will appear on the left
  595.       side and the title string on the right side. Thus, page numbers will
  596.       always be at the outer margin as in books.
  597.  
  598.  
  599.   (3) If odds_first is ON all pages with odd number will be printed first,
  600.       after that the pages with even number will follow. This may be useful
  601.       if you use a printer which loads single sheets automatically.
  602.       After odd pages have been sent to printer a requester will appear.
  603.       Wait until printer has stopped, then turn the stack of sheets and feed
  604.       them back into the printer. Press the gadget to start printing of even
  605.       pages.
  606.  
  607.  
  608.  
  609.    14.Initializing printer 
  610.  
  611.   After pressing "=" NEXT will try to initialize your printer according
  612.   to printer settings. Printer must be online.
  613.   This function may be useful if printer was switched off for some time
  614.   or after aborting a print.
  615.  
  616.  
  617.  
  618.    15.Changing windowsize by key  (SIZE window)
  619.  
  620.   Pressing F1/F2 keys changes size of window. 3 sizes are available:
  621.   maximal, minimal and middle. F1 toggles between min. and max. size,
  622.   F2 between middle and max..
  623.   By default middle size is half as high as maximal, but can easily be
  624.   changed by dragging the size gadget. NEXT remembers the new size und
  625.   will use it on next occasion.
  626.  
  627.  
  628.  
  629.    16.Loading new file  (LOAD/RELOAD)
  630.  
  631.   NEXT offers 5 variants to load a new file:
  632.  
  633.   1. LOAD req (press L):
  634.      Opens the filerequester and presents the directory of current file.
  635.  
  636.   2. LOAD man(ually) (Shift-L):
  637.      The complete name of directory or file wanted has to be typed at the
  638.      bottomline of window, where a prompt will appear. If the name contains
  639.      spaces, you must place it in "". The current directory may be abbre-
  640.      viated by "\".
  641.      You can also give a pattern instead of the filename and use the same
  642.      options as in shell commandline.
  643.  
  644.   3. LOAD newwin (Amiga-L):
  645.      Input as in variant 2. NEXT will create a new process which opens its
  646.      own window or a filerequester if no filename has been given.
  647.      Empty inputs are ignored.
  648.  
  649.   4. RELOAD prev (<):
  650.      Enables you to load a file again which already had been viewed during
  651.      a session. NEXT saves the names of previously loaded files into a
  652.      buffer of 400 bytes. If size of buffer is not sufficient older names
  653.      are replaced by newer ones.
  654.      After pressing ">" a small window which presents all names saved
  655.      will open. You can select a name by doubleclicking or by moving through
  656.      names with cursorkeys (Up/Down) and finally pressing Return.
  657.      If nothing has been selected, Return aborts this function.
  658.      ESC-key and closegadget can be used, too.
  659.  
  660.   5. LOAD next (>):
  661.      Loads next file within directory of current file. Which one will be
  662.      loaded depends on how the files are arranged on disk. It's NOT in
  663.      alphabethical order!
  664.      If a pattern is active (* in front of percentage) only files which
  665.      match this pattern will be loaded (if present). By repeatedly pressing
  666.      ">" you can view all files in the directory. .info-files will be
  667.      skipped. The message "No more files! Continue?" will appear at end
  668.      of directory. Press Return or click on OK-gadget to continue.
  669.      In this case NEXT will scan the directory from beginning, this time
  670.      without comparing with pattern.
  671.  
  672.  
  673.  
  674.    17.Line number  (SHOW line)
  675.  
  676.   After pressing Alt-MB (left or right) the line at mouse position will
  677.   be inverted and the line number is displayed in the titlebar. You can
  678.   press Amiga-Alt, too.
  679.  
  680.  
  681.  
  682.    18.AmigaGuide files  (AMIGUIDE, @MODES)
  683.  
  684.   The meaning of display modes for AmigaGuide files (@LIB, @CON, @PUR) has
  685.   briefly been explained above. They can be used as commandline options
  686.   or tooltypes, but can also be switched later on by pressing "@" or "`".
  687.   Which mode is currently active is shown by the Info-requester.
  688.  
  689.   The @LIB mode uses the amigaguide.library (like Multiview or AmigaGuide).
  690.   A previously loaded file will be unloaded first in order to save memory.
  691.   After closing the AmigaGuide window you'll see an empty NEXT window.
  692.   You may load a new file or quit.
  693.   If the amigaguide.library can't be used for some reason (low memory, no
  694.   library present, crunched AmigaGuide files) the @CON-mode will be used.
  695.  
  696.   The @CON-mode converts AmigaGuide files to readable text. This means,
  697.   all instructions (@NODE etc.) are stripped off and replaced by equivalent
  698.   escape sequences. LINKS will be rendered in colour 2. The end of a NODE
  699.   is marked by a "#". Using the @CON-mode can be advantageous, because the
  700.   text is not presented in small pieces and you can use the search and
  701.   print functions of NEXT.
  702.   The converted file is shorter than the original and can be saved, of course.
  703.  
  704.   The @PUR-mode finally shows AmigaGuide files with all the special instruc-
  705.   tions.
  706.  
  707.   If you look at an AmigaGuide file in @CON or @PUR mode but you want to see
  708.   it additionally as hypertext by means of amigaguide.library, press "A" to
  709.   activate the AMIGUIDE function. This affords a lot of memory because NEXT
  710.   will not unload the file.
  711.  
  712.  
  713.  
  714.    19.Info, filenote  (INFO/NOTE)
  715.  
  716.   After pressing "I" a requester appears with following informations:
  717.       - date of creation/last change of file (OS2+ or arp.lib required)
  718.       - protection bits
  719.       - information if crunched and name of cruncher (Powerpacker V2.x-4,
  720.     PPData, Imploder 3/4/lib, XPK compressor)
  721.       - :filenote
  722.       - number of lines and longest line (rows)
  723.       - number of lines and size of block if marked
  724.       - current display mode for AmigaGuide files and state of print flags:
  725.     smart_print, book_mode, odds_first (+=ON, -=OFF)
  726.       - TEMP: number and total size of temporary files if archives have
  727.     already been extracted
  728.       - current pattern for directory scan if defined
  729.  
  730.   If you press Shift-I a filenote can be given for the current file. You
  731.   must put it in "" if it contains spaces. A previous comment will be
  732.   deleted by typing "". Simply pressing Return without any input doesn't
  733.   change anything.
  734.  
  735.  
  736.    20.Delete current file  (DELETE file)
  737.  
  738.   If you decide that the currently displayed file is no longer needed,
  739.   you can delete it by pressing Amiga-Del. You will be asked whether it
  740.   is really to be deleted. Press OK-gadget to confirm. The deleted file
  741.   will stay in memory, and you can undo deleting by saving it again.
  742.   But due to formatting there may be slight differences to original file.
  743.  
  744.   NEW: In contrast to previous versions binary files can now be deleted, too.
  745.  
  746.  
  747.  
  748.   ›[7m 21.%-Display, Goto  (TOGGLE %, GOTO)
  749.  
  750.   The display of text position (top border) can be switched between % and
  751.   line number by pressing "%". If you are in %-mode the GOTO function
  752.   (activated with "G") will only accept %-values, otherwise line numbers.
  753.  
  754.  
  755.  
  756.    22.Archives  (VIEW archives, FLUSH tempdir, UNPACK all)
  757.  
  758.   For viewing and extracting archives LhA V1.38e and LZX V1.01 or higher
  759.   are needed. They can be somewhere in your path but it's better to define
  760.   their paths explicitly in ENV:next.prefs.
  761.  
  762.   NEXT recognizes archives by internal signs, not by the name suffix. If
  763.   an archive has been detected a list of its contents will be created and
  764.   displayed. You can select a file in the same manner as in a filerequester
  765.   by cursor keys + Return or by doubleclicking on the name.
  766.   Very long lists can be scrolled or moved pagewise by Space/Shift-Down or
  767.   Backspace/Shift-Up. With cursor keys Left/Right you can jump to the top
  768.   or bottom of a list.
  769.   The selected file will be extracted to TEMPDIR/x and displayed afterwards.
  770.   If the selected file happens to be an archive again another list will be
  771.   created.
  772.  
  773.   There are 3 functions dealing with archives:
  774.  
  775.   VIEW archive (V) displays the contents of last archive selected and
  776.   enables extraction of files.
  777.  
  778.   FLUSH tempdir (Shift-Del) deletes all temporary files in TEMPDIR/x if
  779.   there are any. So you'll get back the memory or disk space they occupied.
  780.  
  781.   UNPACK all (U) extracts all files within the current archive to a
  782.   directory which must be specified by you.
  783.  
  784.  
  785.  
  786.    23.Tabs 
  787.  
  788.   After pressing the TAB-key a new tabsize can be defined. The change will
  789.   be visible immediately if the current text contains tabs. It may be necessary
  790.   to reload the file in order to adjust the line length according to new
  791.   tabsize.
  792.   When printing tabs will be expanded by spaces if tabsize is different
  793.   from 8.
  794.  
  795.  
  796.  
  797.    24.Splitted files 
  798.  
  799.   If a file is too large to fit into memory it will be splitted into several
  800.   parts. NEXT will use as much memory as defined by BUFLEN. XPK- und Power-
  801.   packed files can't be splitted. Within a splitted file you can move to
  802.   next or previous part by pressing ">" or "<" respectively. The normal
  803.   effect of these keys (LOAD next, RELOAD) is disabled as long as you are
  804.   within the splitted file.
  805.   It's also possible to get to the next/previous part using several MOVE-
  806.   commands (LINE up/down, PAGE up/down). SEARCH, COUNT, GOTO, PRINT are
  807.   restricted to the current part. This will probably change in a future
  808.   version.
  809.  
  810.  
  811.  
  812.    25.History 
  813.  
  814.   meaning: + new, ^ improved, * changed, - removed
  815.  
  816.  
  817.   V1.91
  818.   =====
  819.  
  820.   Bug fixes:
  821.   - incomplete error message (wrong stringpointer) if filerequester
  822.     couldn't be opened.
  823.   - When starting from Workbench and env:next.prefs didn't exist,
  824.     icon.library couln't be opened (DosBase in a6 8-((). Result: Tooltypes
  825.     were ignored. Crash at least with Kick 1.2/1.3. Sorry!
  826.   - under certain circumstances next.prefs was evaluated incompletely.
  827.   ^ Requesters are now font sensitive using SystemDefaultFont for text
  828.     and ScreenFont for Gadgets.
  829.   ^ more status information on window title bar.
  830.   + VIEW archive now displays total length of uncompressed archive
  831.   + new options CENTER and LINES
  832.  
  833.  
  834.   V1.9
  835.   ====
  836.   + splitting of large files
  837.   + contents of archives and files within archives can be viewed
  838.   + settings file
  839.   + new options: @CON, @PUR, @LIB, LZX, LHA, TEMPDIR, BUFLEN, TABS, FLUSH,
  840.     NOFLUSH
  841.   + display of AmigaGuide files with amigaguide.library (default)
  842.   + new function AMIGUIDE
  843.   + scrollgadget (OS2+ only)
  844.   + print mode "odds first" for printers with automatic loading of paper
  845.   + word statistics show percentage of ASCII strings in binary files
  846.   + filenote can be given for current file (Shift-I)
  847.   + display of text position can be toggled between % and line number (Del)
  848.   ^ MSEARCH now also case sensitive
  849.   ^ "\" can be used to replace the name of current directory when loading
  850.     a new file manually
  851.   ^ marks can be removed separetely
  852.   ^ input line can be deleted with Ctrl-X
  853.   ^ wildcards can be applied to directories
  854.   ^ DELETE requester now with key equivalent for DELETE (D)
  855.   * print modes smart/book/odds are now switched with keys 1/2/3
  856.   - Option "@"
  857.   - BUG: Going to end of input line with "Shift ->" corrupted display if
  858.     input string contained control chars.
  859.  
  860. -------------------------------------------------------------------------
  861.  
  862.  
  863.   Many thanks to
  864.  
  865.   - Nico Francois for publishing his decrunch routine and reqtools
  866.   - Charlie Gibbs for A68k. NEXT has been assembled with it.
  867.   - Matt Dillon for DME und dlink (better and faster than Blink)
  868.   - Hajo Stengert and Andreas Neumann for betatesting and valuable
  869.     suggestions
  870.   - Georges Goncalves for new ideas, some of which will be implemented
  871.     in V2.0
  872.  
  873.  
  874.   Bug reports and suggestions may be sent to following address:
  875.  
  876.  
  877.                   Jürgen Klawitter
  878.                   Marschnerstr. 22
  879.                   12203 Berlin
  880.  
  881.  
  882.  
  883.